home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-13 / esue3v20.zip / ESUE3.DOC < prev    next >
Text File  |  1993-01-25  |  14KB  |  336 lines
  1.  
  2. Shareware Program:
  3.  
  4. ------------------------------------------------------------------------
  5.                                 e s - U E 3
  6. ------------------------------------------------------------------------
  7.  
  8.                              Erhard Schreck
  9.  
  10.  
  11. The program runs on all IBM PCs and IBM PC compatibles and is written in
  12. TURBO BASIC.
  13.  
  14.  
  15. Main Features:
  16. --------------
  17. - edits file of unlimited size (yes it's true)
  18. - edits binary or ASCII files
  19. - find string (also non-displayable characters)
  20. - display filter
  21. - character convertion from EBDIC-code to ASCII
  22. - extracts file blocks
  23. - break-up of huge files into smaller ones
  24. - masked copy
  25.  
  26.  
  27.  
  28. The ZIP file contains 2 files
  29.       ESUE3.EXE            universal editor
  30.       ESUE3.DOC            documentation
  31.  
  32.  
  33. Start:
  34. ------
  35.  
  36. Enter
  37.                       ESUE3 filename   Enter
  38.  
  39. For example
  40.                       ESUE3 \dos\command.com  Enter
  41.  
  42. will show the following initial screen:
  43.  
  44. ---------------------------------------------------------------------------
  45.  
  46.                      ***************************
  47.                      **** Universial Editor ****
  48.                      **** for ASCII or      ****
  49.                      ****     BINARY files  ****
  50.                      **** without           ****
  51.                      **** file size limit   ****
  52.                      ****                   ****
  53.                      **** view and overtype ****
  54.                      ****      mode         ****
  55.                      **** Version: 2.0      ****
  56.                      **** for IBM-AT/PS2    ****
  57.                      ****                 ******
  58.                      ***************************
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  WORK FILE: \DOS\COMMAND.COM
  70. r≡read open      w≡write open
  71. ---------------------------------------------------------------------------
  72.  
  73. As so often, you have to make a decision first. This is solely to protect
  74. your valuable files. If you only want to look at a file just open it to
  75. 'read only' by entering the 'r'. This mode will not allow you, even by
  76. accident,  to change the file currently loaded.
  77.  
  78. In case you intend to make changes press 'w' and UE3 will first make a
  79. working copy of the original file and then load and edit this one. This
  80. guarantees that if anything goes wrong you still got the original.
  81. Only when you leave UE3 with F3 the working copy will be copied to the
  82. original file.
  83. To toggle between 'edit' and 'overtype' mode use the INS-key. The current
  84. setting will be displayed on the upper right corner.
  85.  
  86. Even opening in the write mode allows only the OVERTYPE editing. That
  87. means you never can change the length of a file, what would have
  88. frustrating consequences anyway on any executable file.
  89.  
  90. The example below shows the common COMMAND.COM under edit. The screen shows
  91. the file part where all the error commands are located.
  92. For example you could go ahead and change all these messages into a
  93. different language. Just be carefull to change only readable text.
  94. I found this place by searching for the string 'Duplicate' with the 'Alt+f'
  95. (=find) command.
  96.  
  97. Actually the initial screen had only a width of 16 characters, and
  98. additionally showed the hex code. 16 is the default value when you edit a
  99. BINARY file.
  100. To change the number of characters per line (=record length) press 'Alt+r'
  101. and type in any value up to about 600 (this will take some time to
  102. bring up the new screen). In this case, to scroll the screen
  103. horizontally, use the END or HOME-key or the left and right cursor key
  104. together with the CTRL-key.
  105.  
  106. The program also helps to break-up huge (data) files. Let's say you have to
  107. copy a single file having a length of 2 MBytes to a diskette (you can get
  108. gray hair over that...).
  109. Load the file to UE3 and define a block with F7 and F8 with less than
  110. 1.4 MBytes and write that block with 'Alt+w' to a file.
  111. Than do the same for the rest of the file.
  112.  
  113. To link the files together again you might use the DOS COPY command with
  114. the binary option (see DOS Manual).
  115.  
  116.  
  117.  
  118. Alt+r≡record length
  119. -------------------
  120. Change the record (=display length). 1 to 600 is a valuable number
  121.  
  122.  
  123. Alt+i≡Display filter
  124. --------------------
  125. Gives the opportunity to blank out unimportant characters or to convert
  126. EBDIC-code to ASCII code. Note, these changes are happening only on the
  127. screen the real data are not affected.
  128. The two screens below show unfiltered und 'letters' filtered data.
  129.  
  130. unfiltered:
  131. ---------------------------------------------------------------------------
  132. \DOS\COMMAND.COM                       Pos %= 69  File Length= 48006  * view *
  133. Rec=    434 Col= 34  Pos=  32,942   Value=117 (h75)  2-byte-int= 28789
  134.  
  135. ......R...ç... ...,...S...Ä...┐...Φ. .^.,.º.@.δ.A...B.T.T.₧.U.≤.V.q.h.╣.i.Ω.
  136. |.j.É.¡.ñ.π.╕.Æ.╠.ß.═.9.α.¿.⌠.±...Y...ú...≈...<.0.├.D...E.a.F.ñ.G.. H.╛ I.!!
  137. J.ê!X.∞!Y.`"Z.┌"[.-#l.╠#Ç.α#ü..$é.a$.%1 bytes free..#File cannot be copied o
  138. nto itself...Insufficient disk space...Invalid code page...Invalid date...In
  139. valid time...Invalid path..!Press any key to continue . . ....Unable to crea
  140. te directory..!Volume in drive %1 has no label...Volume in drive %1 is %2...
  141. Volume Serial Number is %1-%2..'Duplicate file name or file not found...Inva
  142. lid path or file name...Out of environment space...File creation error...Bat
  143. ch file missing.....Insert disk with batch file...Bad command or file name..
  144. .Access denied ..)Content of destination lost before copy..$Invalid filename
  145.  or file not found...%1 file(s) copied...%1 file(s) .Invalid drive specifica
  146. tion..&Code page %1 not prepared for system..+Code page %1 not prepared for
  147. all devices...Active code page: %1...NLSFUNC not installed.. Current drive i
  148. s no longer valid.Label not found...Syntax error...Current date is %1 %2...S
  149. unMonTueWedThuFriSat.Enter new date (%1): .Current time is %1...Enter new ti
  150. me: .,    Delete (Y/N)?<All files in directory will be deleted!..Are you sur
  151. e (Y/N)?.IBM DOS Version %1.%2.Invalid directory..6Invalid path, not directo
  152. ry,..or directory not empty...Must specify ON or OFF...Directory of %1...No
  153. Path...Invalid drive in search path...Invalid device...FOR cannot be nested.
  154. .%Intermediate file error during pipe..&Cannot do binary reads from a device
  155.  Alt+r≡record length   Alt+i≡Display filter   F4≡locate  ESC≡more...
  156.  ALT+o≡record offset   Alt+c≡copy maske   ALt+u≡unit (bin/hex/dec)
  157. ---------------------------------------------------------------------------
  158.  
  159. letters filterd:
  160. ---------------------------------------------------------------------------
  161. \DOS\COMMAND.COM                       Pos %= 69  File Length= 48006  * view *
  162. Rec=    434 Col= 34  Pos=  32,942   Value=117 (h75)  2-byte-int= 28789
  163.  
  164.       R               S                         A   B T T   U   V q h   i
  165.   j                               Y                 D   E a F   G   H   I
  166. J   X   Y           l             a     bytes free   File cannot be copied o
  167. nto itself   Insufficient disk space   Invalid code page   Invalid date   In
  168. valid time   Invalid path   Press any key to continue         Unable to crea
  169. te directory   Volume in drive    has no label   Volume in drive    is
  170. Volume Serial Number is         Duplicate file name or file not found   Inva
  171. lid path or file name   Out of environment space   File creation error   Bat
  172. ch file missing     Insert disk with batch file   Bad command or file name
  173.  Access denied    Content of destination lost before copy   Invalid filename
  174.  or file not found      file s  copied      file s   Invalid drive specifica
  175. tion   Code page    not prepared for system   Code page    not prepared for
  176. all devices   Active code page       NLSFUNC not installed   Current drive i
  177. s no longer valid Label not found   Syntax error   Current date is         S
  178. unMonTueWedThuFriSat Enter new date        Current time is      Enter new ti
  179. me        Delete  Y N   All files in directory will be deleted   Are you sur
  180. e  Y N   IBM DOS Version       Invalid directory   Invalid path  not directo
  181. ry   or directory not empty   Must specify ON or OFF   Directory of      No
  182. Path   Invalid drive in search path   Invalid device   FOR cannot be nested
  183.   Intermediate file error during pipe   Cannot do binary reads from a device
  184.  Alt+f≡find  Alt+L≡load file Alt+w≡save block ins≡edit ESC≡more...
  185. ESC≡help F2≡DIR F3≡exit F7≡block beg F8≡block end F9≡DOS Alt+m≡file mode
  186. ---------------------------------------------------------------------------
  187.  
  188.  
  189.  
  190. F4≡locate
  191. ---------
  192. Allows to position to a specific place within the file, By hitting F4 you
  193. get a prompt to locate either to a record number or to a Byte number.
  194. Another method to browse through a file is by hitting 'Alt+1' ... 'Alt+9'
  195. or 'Alt+0'.  This locates the cursor to 10%, 90% or 100% (=the end) of the
  196. file.
  197.  
  198. ALT+o≡record offset
  199. -------------------
  200. This is a very helpful feature. It helps e.g. to skip a header part in a
  201. file that mainly contains records of a fixed length (like DBASE etc).
  202.  
  203.  
  204.  
  205. Alt+c≡copy maske
  206. ----------------
  207. Allows to extract any periodic pattern. Again let's assume you have a data
  208. file containing data in the form x1,y1,x2,y2....xn,yn, and each number
  209. represented by 4 bytes.
  210. To extract all x values the copy mask wuold look like
  211.                              11110000
  212.  
  213. To extract e.g. all odd x,y pairs the mask would look like
  214.                     1111111100000000
  215. ans so on. Any pattern up to a length of 70 characters is possible.
  216.  
  217.  
  218. ALt+u≡unit (bin/hex/dec/oct/all)
  219. --------------------------------
  220. Shows on the left side of the screen all displayable characters and
  221. additionally their bin/hex.... counterparts.
  222. to get a readable screen the record length has to be choosen right
  223. If all number systems shall be displayed at once a record lenth of 1 is
  224. necessary.
  225.  
  226.  
  227.  
  228. Example: Initial opening screen with record length=16 and HEX characters
  229.  
  230.  
  231. \DOS\COMMAND.COM                       Pos %=  0  File Length= 48006  * view *
  232. Rec=      3 Col=  1  Pos=      33   Value=  0 (h0 )  2-byte-int=     0
  233.  
  234. Θ]. x.  ╖.  u.      E9 5D 14 00 78 14 00 00 B7 0E 00 00 75 0D 00 00
  235. à.                  85 11 00 00 00 00 00 00 00 00 00 00 00 00 00 00
  236.                     00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
  237.      √Φd ... ...    00 00 00 00 00 FB E8 64 00 1E 0E 2E FF 2E 04 01
  238. √ΦY ... ...√ΦN .    FB E8 59 00 1E 0E 2E FF 2E 08 01 FB E8 4E 00 1E
  239. .. ...√ΦC ... ..    0E 2E FF 2E 0C 01 FB E8 43 00 1E 0E 2E FF 2E 10
  240. .Φ9 ... ...Φ/ ..    01 E8 39 00 1E 0E 2E FF 2E 14 01 E8 2F 00 1E 0E
  241. . ...Φ% ... ...Φ    2E FF 2E 18 01 E8 25 00 1E 0E 2E FF 2E 1C 01 E8
  242. . ... . .Φ. ...     1B 00 1E 0E 2E FF 2E 20 01 E8 11 00 1E 0E 2E FF
  243. .$.Φ. ... .(.£.Ç    2E 24 01 E8 07 00 1E 0E 2E FF 2E 28 01 9C 2E 80
  244. >4. t.Φ. s.Φ. ¥├    3E 34 01 00 74 08 E8 0C 00 73 03 E8 1A 00 9D C3
  245. Ω5.  SP┤.. .0..└    EA 35 01 00 00 53 50 B4 07 2E FF 1E 30 01 0B C0
  246. X[u.∙├°├SP┤.. .0    58 5B 75 02 F9 C3 F8 C3 53 50 B4 05 2E FF 1E 30
  247. ..└t.X[├δ■═!·..╝    01 0B C0 74 03 58 5B C3 EB FE CD 21 FA 0E 17 BC
  248. >.√..£.á@.¿Çt.$    3E 05 FB 0E 1F 9C 2E A0 40 05 A8 80 74 07 24 7F
  249. . .,..Ç&@.¥Θb .    2E FF 1E 2C 01 2E 80 26 40 05 7F 9D E9 62 FF 02
  250.   ...A.  ...        00 00 01 05 02 41 02 00 00 02 0C 02 00 00 00 00
  251.      ....,..*.      00 00 00 00 00 02 1E 02 03 2C 02 03 2A 02 00 00
  252.                .    00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 01
  253. ...  .8. .i.        05 02 02 00 00 01 38 02 20 02 69 04 00 00 00 00
  254.  Alt+f≡find  Alt+L≡load file Alt+w≡save block ins≡edit ESC≡more...
  255. ESC≡help F2≡DIR F3≡exit F7≡block beg F8≡block end F9≡DOS Alt+m≡file mode
  256.  
  257.  
  258.  
  259. Example: record length=1 and all number systems
  260.  
  261. \DOS\COMMAND.COM                       Pos %=  0  File Length= 48006  * view *
  262. Rec=      1 Col=  1  Pos=       1   Value=233 (hE9)  2-byte-int= 24041
  263.                    Byte-No HEX DEC OCT   BIN
  264. Θ                  001:    E9 233 351 11101001
  265. ]                  002:    5D 093 135 01011101
  266. .                  003:    14 020 024 00010100
  267.                    004:    00 000 000 00000000
  268. x                  005:    78 120 170 01111000
  269. .                  006:    14 020 024 00010100
  270.                    007:    00 000 000 00000000
  271.                    008:    00 000 000 00000000
  272. ╖                  009:    B7 183 267 10110111
  273. .                  010:    0E 014 016 00001110
  274.                    011:    00 000 000 00000000
  275.                    012:    00 000 000 00000000
  276. u                  013:    75 117 165 01110101
  277. .                  014:    0D 013 015 00001101
  278.                    015:    00 000 000 00000000
  279.                    016:    00 000 000 00000000
  280. à                  017:    85 133 205 10000101
  281. .                  018:    11 017 021 00010001
  282.                    019:    00 000 000 00000000
  283.                    020:    00 000 000 00000000
  284.  Alt+f≡find  Alt+L≡load file Alt+w≡save block ins≡edit ESC≡more...
  285. ESC≡help F2≡DIR F3≡exit F7≡block beg F8≡block end F9≡DOS Alt+m≡file mode
  286.  
  287.  
  288. Alt+m=file mode
  289. ---------------
  290. This allows to chose the appropriate file mode. If the program finds an
  291. ASCII character 26 at the end of the file it's very likely to be a text
  292. file and UE3 will open it in text mode. Anything else will be opened as
  293. binary file.
  294. Some text editors don't append character 26, so UE3 will open it in binary
  295. mode. This will be a reason to change the mode manually with 'Alt+m'
  296.  
  297.  
  298.  
  299. Known bugs:
  300. -----------
  301. The editor keeps only about 20 records in memory. If you try to scroll
  302. further up or down a new file portion has to be loaded. Unfortunately thsi
  303. doesn't work perfectly with the consequence that you cursor position might
  304. be slightly of. It's better to use the PdUp or PgDn-keys to brows through a
  305. file or the F4-key or alt+1 ... Alt+0.
  306. Scrolling within one loaded block works well.
  307.  
  308.  
  309.  
  310. The Copyright is owned by Erhard Schreck.
  311. Compuserve 70303.744
  312.  
  313.  
  314. Nobody is allowed to distribute this program for commercial use.
  315. If you are happy with it you may send a check (I accept any amount,
  316. until I've catched up with Bill Gates).
  317.  
  318. Erhard Schreck
  319. 1098 Foxchase Dr. #379
  320. San Jose, CA 95123
  321.  
  322. If you are not happy, don't send a check, but let me know.
  323.  
  324.  
  325.  
  326.  
  327. Disclaimer:
  328. -----------
  329. I'm not responsible for any data loss or damage that might be related to
  330. this program (even it never happened to me).
  331.  
  332. Have fun,
  333.  
  334. Erhard Schreck
  335.  
  336.